hfViolinplotR Documentation

Violin plots of Hf isotopic ratios/model ages

Description

Produces a violin plot for a given isotopic parameter, respecting groups.

Usage

hfViolinplot(what = NULL, col = NULL, border = "black", rectCol = "white", 
    lineCol = "white", pchMed = NULL, colMed = "black", cex = 1.5, 
    xlab = "", ylab = "", ...)

Arguments

what

the variable name; see Details

col

colour(s) to fill the violins

border

outline colour(s) for the violins

rectCol

fill colour(s) for the box(es)

lineCol

colour of the box outline and whiskers

pchMed

plotting symbol(s) used for the median point(s)

colMed

colour(s) for the median point

xlab

character; label for the x axis

ylab

character; label for the y axis

cex

numeric; relative size of the text

...

additional parameters for the vioplot function

Details

The violin plots (Hintze & Nelson 1998) have been proposed as yet another alternative to boxplots illustrating the distribution of univariate statistical data. In effect they combine boxplot with two density traces placed symmetrically around it. The box extends between the two quartiles; median is denoted by a point. The whiskers show the whole range without outliers. However, unlike in the boxplots, outliers are not shown as individual points.

hfViolinplot.png

The variables to choose from are:

Menu item Explanation
Age (Ma) U–Pb ages
176Hf/177Hfi Initial Hf isotopic ratios
EpsHfi Initial ε(Hf) values
HfTCHUR.1stg Single-stage CHUR Hf model ages
HfTDM.1stg Single-stage DM Hf model ages
HfTDM.2stg Two-stage DM Hf model ages

These can be specified also upon the function call, as the parameter 'what'. The possibilities are 'Age (Ma)', '176Hf/177Hfi', 'EpsHfi', 'HfTCHUR.1stg', 'HfTDM.1stg' or 'HfTDM.2stg'.

Value

A list object with statistical summary (upper and lower limits, median, two quartiles) of the data as produced by the function 'vioplot'.

Plugin

Hf.r

Author(s)

This is merely just an interface to the function vioplot from the namesake package designed by D. Adler, S.T. Kelly, T. Elliott and J. Adamson.

Implemented by Vojtěch Janoušek, vojtech.janousek@geology.cz

References

Adler D, Kelly ST, Elliott T, Adamson J (2022) vioplot: violin plot. R package version 0.4.0. Accessed on February 16, 2024, at https://github.com/TomKellyGenetics/vioplot

Hintze JL, Nelson RD (1998) Violin plots: a box plot–density trace synergism. Am Stat 52:181-184. doi: 10.2307/2685478

See Also

vioplot, hfBoxplot, hfStripplot, hfHist

Examples

sampleDataset("khantaishir_Hf")
groupsByLabel("sample")    
    
hfViolinplot("EpsHfi")
    
hfViolinplot("HfTDM.1stg", col = "lightblue")